Docs re-architecture: two audience tracks, a 5-chapter creator guide, an AI features showcase, and a consistent icon system - #14
Draft
anushkmittal wants to merge 33 commits into
Draft
Conversation
Contributor
|
Preview deployment for your docs. Learn more about Mintlify Previews.
💡 Tip: Enable Workflows to automatically generate PRs for you. |
Contributor
|
Preview deployment for your docs. Learn more about Mintlify Previews.
💡 Tip: Enable Workflows to automatically generate PRs for you. |
…tant, meme friend, creative collaborator)
…r sheets in capabilities
cursor
Bot
changed the title
…rate ideas cookbook
cursor
Bot
changed the title
…scheduled actions, image annotation, chat-history search, and shape message effects (not live for users)
…ide (redirect to chats-101), reconcile engine guide with model picker
cursor
Bot
changed the title
cursor
Bot
changed the title
… level; remove dormant Alive mode from glossary
…nverifiable claims, de-slop
cursor
Bot
changed the title
…ming existing craft content into the arc
…eference by audience
cursor
Bot
changed the title
…k icon library to Font Awesome
… replace blank Lucide names and sparkle/wand icons; balance the chapter grid
cursor
Bot
changed the title
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
3 participants
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
What this PR does
Re-architects the Shapes docs around who is reading (cofounder.co style): a tiny front door that routes, a Use Shapes track, a Make Shapes five-chapter creator guide, and a shared AI features showcase. Plain human prose, verified-live capabilities only, nothing dormant.
Pass 8 (this update): icons, dupes, flow
messages-square,users-round,cpu,grid-2, etc.) rendered blank, while Font Awesome names (shapes) rendered. That's the lopsided front-door fork and the scattered missing icons.commentsfor Use,cubesfor Make), parallel body length, and consistent naming ("make my own Shape", not "AI").docs.jsonand standardized one icon vocabulary across every page (concept → one icon used everywhere). Replaced all blank Lucide names, removed every decorative sparkle/wand icon, and de-duplicated icons that meant two things.colsmatch card counts.Earlier passes (still included)
Two-track IA (Start here / Use Shapes / Make Shapes chapters / What the AI can do / Reference). Plain-language rewrite and full anti-slop line-edit of the front door and deep pages. Dormant-code purge (dice, character sheets, file gen, scheduled actions, image annotation, chat-history search, shape message effects, Alive mode) kept out. Corrected facts (up to 5 Shapes reply in turn; 300+ models; no public dev API).
Verified vs code
No new feature claims. Icons are presentational; the audit didn't touch any capability claim. Use-track scenarios stay within verified-live behavior.
Validation
docs.jsonvalid; all 77 page references resolve; icon library set; redirects intact; no orphans.<Card>has an icon; all icons map to the Font Awesome set.npx mintlify broken-links→ "success no broken links found."Needs a human: real images
Precise
{/* SCREENSHOT */}placeholders are in place across the journey. The consolidated shot list is in the agent report. The one hero the landing most needs: a multiplayer group chat with people and a Shape talking together.